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1, INTRODUCTIO N 

la September! 1971, the CACHE Committee issued the document, 
"Standards Cor CACHE F0RTRAN Computer Programs/' The purpose of that 
document was to set forth standards governing programming, documentation, 
testing, and distribution for F0RTRAN computer programs to be made 
available through the CACHE Committee to chemical-engineering educators. 
A May, 1972, revision of the standards Included a sample program to 
illustrate the programming and documentation standards. Approximately 
100 computer programs that conform to these standards will soon be 
published and distributed by the CACHE Committee. 

In general, the CACHE standards presented in the aforementioned 
document apply to individual self-standing programs or subroutines that 
can be implemented readily by the user at his own computing center. 
However, large-scale or complex systems of programs often require 
special programming techniques for r^ady use or efficient operation. 
Frequently, these systems are best installed and maintained at one 
computer center, with remote access provided for users elsewhere. 
Such systems, which are outside of the scope of the former CACHE 
standards, are defined herein as "large-scale programs. M 

A number of large-scale computer programs are of definite 
interest in chemical-engineering education; for example, 

a. computer-aided process-design and simulation programs that 
perform material and energy balances, equipment sizing, and/or economic 
evaluations for steady-state, continuous chemical processes; 

b. component and mixture physical-property calculation programs; 



c. some complex equipment-design programs; 

d. dynamic process-simulation programs* which simulate process 
startup, shutdown, and other unsteady operations; 

e. computer-aided process-synthesis programs, which develop 
process flow diagrams, including equipment selection and arrangement; 

£« specialised process system programs for pollution control, 
energy management, etc. 

While such programs are available and are in use at a number of 
universities, the widespread implementation of such programs has bern 
hindered because they ar« generally difficult to install and maintain 
on university computers. In order to utilize the programs, an educator 
has been required to have considerable programming and systems experience 
and to be agreeable to spending a great deal of time, first in modifying 
the program to make it function properly on his university's particular 
computer and then in maintaining it. An alternative procedure foi util- 
izing large-scale computer programs is to install and maintain each 
program at only one computer, with access by others via communications 
networks. The present document is concerned with this alternative. 
Included are discussions of desirable features of large-scale programs, 
programming standards, documentation, program-installation and system 
requirements, program testing, and program distribution. It is intended 
that, within the near future, a limited number of large-scale programs 
that conform to the standards presented here will be selected by the 
CACHE Committee for use by chemical-engineering educators. 



2. DESIRABLE FEATURES OF LARGE-SCALE PROGRAMS 

Before programming standards are consideredi it is of interest to 
summarise desirable features of large-scale programs . Without due con- 
sideration to this topic, the complexity normally associated with large- 
scale programs may limit their application even though the barriers to 
program access have been essentially removed. 

2.1 Running Cost ant 1 Running-time Limit 

In an academic environment, the cost of running the program 
may be the major factor. Consequently, it is well to establish some 
benchmarks for the cost of running the program. In general, the 
charge per run will be dependent upon the size of the computer, the 
number of instructions, the iterative nature of the algorithm(s) , 
the amount of input and output, the nature of the mathematical func- 
tions utilized, the core space required, the disk file or other 
storage needed, etc. Because of this complex dependency, it* is not 
possible to determine a simple quantitative relationship between 
the run charge and the factors listed above. Therefore, it must 
suffice to state simply that the charge per run should be in the 
range of approximately one to ten dollars, where the lower figure 
applies to programs that would usually be run several times during 
a course by students and the higher figure applies to programs that 
need only be run once or twice during a course or could be run by 
groups of students with little loss of instructional effectiveness. 



In order to protect the user, the program should have a built- 
in run- termination feature In the event that execution time exceeds a 
limit specified as input by the user. Pertinent results computed 
prior to such a termination should be printed. 

2.2 Program Access 

Experience indicates that ease of program access from a teletype! 
or other remote job entry (RJE) device can vary widely. Two factors 
are involved: (1) the commands used to c-11 the program and (2) the 
manner in which the program is stored and entered into the computer 
memory. The commands used to call the program from an RJE device should 
be as simple and as brief as possible. For example, the system 
commands required before typing in the input data and then for calling 
and executing a computer-aided process-design program could simply be: 
EDIT 

NEW DATI > before entering data into data file DATI 
SAVE 

OLD CAPD ) 

> to call and execute program CAPD with data in DATI 
RUN J 

In contrast, some systems are known to require as many as ten commands 
to access and use a program. 

The most desirable method of program storage is a high-speed, 
high-word-capacity on-line device, because it can rapidly and automatic- 
ally load the program into core without requiring operatoi intervention. 
If the use of such a device is not possible, however, then the program 
must be stored on a removable device, which would require mounting bv 
an operator. Tapes are acceptable but undesirable. 



2.3 Data Input 

% With large-scale computar programs, the amount of input data 

required can be substantial; and the need is great to minimize errors. 
For this reason, the use of free-format input is highly desirable. The 
input should be as compact as possible, free of redundancy; and, where- 
ever possible, default value*.* should be provided and clearly defined to 
the user. Another advantage of f ree-formr.i: input is that it essentially 
eliminates the need for special input-data sheets for each program. 

At least two types of free-format input are in common use. The 
first type, referred to here as "N0NAME," consists of the values of 
several variables on each line, with each variable separated by a comma 
and without regard to any particular field width. Delimiters are util- 
, ized to signal the end of a group or subgroup of data values. For 

^ example, the following is a line of data: 10, 240., 0.,,, 4., 1.; 

The second free-format input scheme, referred to here as the 
"NAMELIST" type, is based on the use of names for groups of data values 
in a manner similar to the use of NAMELIST in F0RTRAN. Each line of 
data input is preceded by the data name. Groups of data values are 
ordered. Again, the input values are separated by commas and closely 
spaced. Individual elements of data arrays may also be initialized. 
An example of a line of this type of input is as follows, with slightly 
different forms also possible: C0NTRL 1, .0001,20,0,1,10,0. 

Both types of free-format input are acceptable. However, the NAME- 
LIST type is preferable because the data groups may be entered usually 
without respect to any particular order and because no terminal delimiters 
may be required. Furthermore, the input-data values are readily identified 
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because they are asaociated with a group nana. Regardless of the type 
of free-format input used, each line of data ehould be .identified by a 
eequence number that precedee the data liet. Data entry for multiple 
cases nay be by exception. 
2.4 Program Output 

Printed output from a large-scale computer program should include 
all user-entered input data, as well as the results of calculations* In 
many cases, an option should be provided such that the user can obtain 
either a very limited amount of output or various degrees of more detailed 
output that traces program execution. Other options should be provided to 
allow the user to examine any data or data files accessed by the program. 
Except for debugging purposes, output must not consist of unlabied values. 
Furthermore, the use of general labels should be avoided. When quantities 
carry units, these should be attached to the label. Thus, for example » 



In addition, when chemical components are involved, the output should 
use generally accepted names or abbreviations; e.g., those that appear 
in the Handbook of Chemistry and Pkyaias. Thus, for example, 



HEAT EXCHANGER AHEA, SQ. FT. 



2500. 



is much preferable to 



PARAMETER 5 



2500. 



C0MP0NENT 



M0LE FRACTI0N 



METHANE 



0.1532 



is much preferable to 



C0MP0NENT 



M0LE FRALTI0N 



1 



0.1532 



2,5 Error Messages 

An Important feature of t large-scale computer program Is the use 
of error messages. They should be incorporated extensively into the pro- 
gram to guide the user in the event that the program runs into difficulty 
during execution. The error messages should be explicit » intelligible to 
the user* and flagged sufficiently to draw the attention of the user. 

Every attempt should be made by the program to check the input 
data for obvious irregularities, When detected» an error message should 
be printed, If the program is to be executed directly or shortly after 
data entry » the user should be given the opportunity to check and correct 
the particular llne(s) of input data before execution proceeds. 

Other types of errors detected during execution may be followed 

by one of two courses of Action after the error message has appeared. 

tf a serious error is detected » the program may be caused to terminate. 

If the error is not too serious » the program may be allowed to continue. 

Examples of each of these types of error messages ares 

**IN INPUT DATA* NUMBER OF SPECIFIED STAGES IS OUTSIDE 
OF PR0GRAM LIMITS, REVISE DATA AND RESTART. 

**BUBBLE-POlNT CALCULATION NOT CONVERGED AFTER LIMIT OK 
15 ITERATIONS. CALCULATIONS ALLOWED TO PROCEED WITH 
LAST TEMPERATURE CALCULATED. 

**O0MPUTED TEMPERATURE DRIVING FORCE IS NEGATIVE. 

SPECIFICATIONS MAY BE IMPROPER. PROGRAM TERMINATED. 

Error messages may also includo a code number that references a manual, 

where a more detailed explanation is offered. 

In summary, the above-discussed desirable programming features of 

large-scale computer programs are all aimed at reducing the time, effort, 

and expense required of the user. Every effort should be made to prepare 

programs which moot these objectives. 
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3. PROGRAMMING STANDARDS 

Large-scale computer programs need not necessarily be coded in 
FORTRAN but. wherever poaaiblt, should uee FORTRAN and other hlgh-levol 
languages thst are wall maintained for the host computer. When FORTRAN 
la utilised, USA Standard F0RTRAN, aa described In USAS X 3.9-1966 and 
discussed in the CACHE standards. 1 is required, with the following 
modifications: 

a. Stable, well-established language improvements— mixed- 
mode expressions (see Section 2.3 of standards 1 )— on the host computer 
are acceptable. 

b. The program may exceed 32K words of machine instructions or 
single-precision floating-point numbers (Section 2.S 1 ). 

c. The magnitude of constants is restricted only by the host 
computer (Section 2.6 1 ). 

d. Hardware limitations on the host computer do not apply. However, 
all large-scale systems must be accessible to low-speed terminals. 

e. An option must be provided to limit printed output from the 
program to 70 columns 2 so that teletype output can be convenientlv used 
(Section 2.7 1 ). 

f . Functions used by the program may include any functions 
regularly maintained on the host computer (section 2.81 1 ). 

Other modifications may be permissible, particularly with respect 
to programming practice (section 2.6 1 ), as long as the program is execut- 
able on the particular host computer to be employed. 

Standards for CACHE FORTRAN Computer Programs (Washington, D. C: 
Commission on Education, National Academy of Engineering, May, 1972). 

2 For interactive programs usable with alphanumeric video terminals, 
the limiting option should be 50 columns. 
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When a language other than F0RTRAN la anployad» It la aaaantial 
only that tha programing conform to good profaaalonal practice, thereby 
permitting it to be conpilad and axacutad on tha particular hoat computer 
to be employed. Such apecial catea muat be worked out individually with 
the CACHE Committee. 

4. DOCUMENTATION 

The documentation for large-scale computer programs will consist 
cf two separate parts, an Introductory Deacription and a User's Guide. 
In certain cases, a Systems Guide may alao be necessary. 

4.1 Introductory Descriptio n 

The Introductory Description will be similar to that described 
in Standards for CACHE FORTRAN Computer Programs, It will consist of 
the following sections: 

a. Standard Title Page 

b. Technical Description 

c. Educational Aspects 

The standard title page, presented on p. 10, may omit certain 
items of program development that are either confidential or not pertinent 

The technical description should be brief and would be best pre- 
sented by examples of the types of problems that the program is designed 
to solve. The main purpose of this section is to present just enough 
description that a potential user can decide whether the particular 
program is applicable to the problem that he needs to solve. Mathematical 
and computational details should not be presented here. 



CACHE LARGE-SCALE COMPUTER PROGRAM 



Program Name: 
Language (a) 

1. Title: (1 line) 

2 . Author (s) J 

3. Cognizant Supervisor: 

4. Organization Name, Address, and Telephone Number: 



CACHE Number: 
Date Issued: 
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5. Abstract: (20-line maximum) 



6. Host Computer and Location: 

7. Remote Terminals Supported: 



8. CACHE Representative and Telephone No.: 



9. Host Computer Representative and Telephone No.: 
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The section on educational aspects should follow the outline 
given in Section 3.3 of Standards for CACHE FORTRAN Computer Programs. 

4.2 User's Guide 

The User's Guide should provide a description of the engineering, 
mathematical t and logical methods used, together with step-by-step 
instructions describing how to use the program. A graded set of sample 
problems with solutions should be included. The following is a 

suggested outline for the User's Guide: 

1. Summary 

2. Introduction 

3. General Program Description 

4. Program Restrictions and Constraints 

5. Preparation of Input Data 

6. Description of Program Output 

7. Error Messages and Actions 

8. Program and Subprograms (identify basic equations and methods 
of calculation, with reference to pertinent literature) 

9. Method of Adding Modules or Subroutines* 
10. Sample Problems 

The CACHE Committee has on file examples of User's Guides that 
can be made available. In some cases, the CACHE Committee itself may 
prefer to assist in the preparation of such a guide. 

4.3 Systems Guide 

In addition to the type of documentation described above, a list 
of computing-system requirements must be submitted. A systems manual 



ERIC 



*This must not allow the user to change the system. 
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may be required for programs that naed a certain degree of sophistication 
with regard to their implementation at the host computer. It is recom- 
mended that tho manual, if required, oe prepared with the assistance of 
the CACHE Committee. 

5. PROGRAM INSTALLATION AND MAINTENANCE 

The installation of a large-scale computer program on a host 
computer will be a cooperative effort among the program supplier, a 
CACHE Committee representative, and a member of the staff of the host 
computer center. 

Initially, during Stage 1 of CACHE Committee operation of large- 
scale computer programs, program maintenance will be the responsibility 
of the program supplier. The supplier may be permitted to update the 
program after consultation with the CACHE representative and after 
notification of all program users. The program supplier will be 
responsible for providing modifications of the appropriate documentation 
to the CACHE Committee represi native. 

Eventually, program maintenance will be the responsibility of 
the program supplier, the CACHE maintenance corps, and the staff of the 
host computer center. Where the level of usage is great, the staff of 
the host computer center will be encouraged to provide application 
program support. 

Normally, routine maintenance of the program will consist of 
checking the computer-center program file once each month and running a 
sample problem at least once every six months. This will be the respon- 
sibility of the CACHE Committee representative. 



6, CONSULTATION SERVICES 

In general, it is anticipated that the large-scale programs will 
be sufficiently tested and documented that supplier consultation with 
users will not normally be necessary. The following refers mainly to 
procedures for handling errors. 

Large-scale-program users will refer errors suspected to be 
associated with the operating system of the host computer to the staff 
of the host computer center. A computer "mail box" will be provided 
at the host computer. 

Initially, problems associated with the execution of the large- 
scale program will be reported to the program supplier. It is 
important that program suppliers be willing to answer questions on 
a regular basis. Eventually, these problems will be reported first 
to the CACHE maintenance corps and then to the program supplier. 

7. PROGRAM TESTING 

Before final acceptance by the CACHE Committee, a candidate 
large-scale computer program will receive a comprehensive check-out 
according to the following procedure. This should ensure success when 
the program is subsequently accessed by users. 

a. The program supplier will run sample problems at his computer 

center. 

b. A CACHE Committee representative will run the same sample 
problem after the program has been installed at the host computer. 



Ci The CACHE Committee representative will run a new problem 
that he devises ♦ 

d» Another CACHE Committee member or associate will run a 
sample problem by RJE from a different location* 

The basic objective is to achieve program use without interaction 
with the program supplier. Howuver, if difficulties arise in carrying 
out this procedure! it may be necessary to contact the program supplier. 

8. PROGRAM REVIEW AND DISTRIBUTION 

A representative of the CACHE Committee will serve as the program 
reviewer and documentation editor for the large-scale computer programs. 
He will seek the assistance of other CACHE members and associates in 
carrying out this function. Submission» review» and approval of each 
candidate program will occur in several distinct steps , characterized 
by the documentation required: 

a. a title page containing the program abstract in the form 
shown on page 10; 

b. documentation for the Introductory Description, as described 
earlier i including Technical Description and Educational Aspects, 
together with a preliminary Program Description and a sample problem 
with input and printed output; 

c. a draft of the User's Guide, as described above; 

d. a draft of the systems manual, if required; 

e. installation of the program on the host computer; 



f. a four-step check-out of the program* as outlined above; 

g. the final version of the User's Guide. 

At each of the above steps, candidate programs will receive 
careful review to make sure that they meet the standards discussed 
above. Careful attention will be paid to those desirable features 
discussed earlier. Potential program suppliers may be requested to 
modify their programs or write-ups to gain acceptance. 

It is planned that program booklets will be published as required, 
which will contain the Introductory Descriptions for several large-scale 
programs. The User's Guides will be published separately. It is anti- 
cipated that the program booklets will receive wide distribution, while 
distribution of the User's Guides will, in general, be restricted to 
serious users who request copies. 

9. LIST OF TYPES OF LARGE-SCALE PROGRAMS 

A major goal of the CACHE Committee is to achieve greater involve- 
ment of chemical-engineering faculty in problem solving by means of the 
digital computer. For this reason, it is believed that large-scale 
programs for adoption by the CACHE Committee should be selected to cover 
most areas of undergraduate and graduate education in chemical engineering 
A list of possible program types that would meet this criterion is given 
in Table I. While other types of programs will be considered, those 
listed are particularly desired. In addition, candidate programs should 
be such that students can learn to use them in a reasonable period of 
time. In general, programs that are likely to be used only by the 



instructor for demonstration purposes will not be given serious consid- 
eration. 



TABLE I: POSSIBLE TYPES OF PROGRAMS FOR INSTALLATION ON NETWORKS 



PROGRAM AREA 


EXAMPLE 


Material and energy balances 


Material and energy balances for steady- 
state processes 


Thermodynamics 


Thermodynamic & other physical properties 


Equilibrium-stage calculations 


Equilibrium flash with necessary data 
base 


Equilibrium-stage calculations 


Complex distillation package 


Heat transfer 


Heat-exchanger design 


Mass Transfer 


Design of a nonisothermal packed 
absorber 


Fluid mechanics 


Piping network 


Kinetics 


Adiabatic plug-flow reactor 


Kinetics 


Fixed-bed catalytic reactor 


Process design 


Steady-state process design or 
simulation 


Process design 


Dynamic simulation 


Process synthesis 


Process synthesis 


Optimization 


Multivariable constrained optimization 


Optimization 


Multivariable unconstrained optimization 


Pollution control 


Water-treatment-plant design 


Pollution control 


Environmental games 
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